home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Megahits 3
/
Megahits 3 (1994)(GTI - Rhein-Main-Soft)(DE)[!].iso
/
module
/
utilities
/
optimod
/
optimod.doc
< prev
next >
Wrap
Text File
|
1994-10-14
|
15KB
|
414 lines
(OS2.0 Only)
Q-TECH Tools...
O P T I M O D
version 4.00
- THE PROTRACKER/NOISETRACKER MODULE OPTIMIZER -
Written by Joakim Ögren
(C) Copyright 1992,93 Quality Technology - All rights reserved
1. Distribution
¯¯¯¯¯¯¯¯¯¯¯¯
All these programs are copyrighted by Quality Technology. But
they are freely distributable as long as it's not included in any
comercial product or sold for a price higher than the cost for the
disk and drive use. All documents and files must always be kept
together. The only exception is when it's copied to eg a harddrive
for own use. You are not allowed spread it unless it's a 100%
complete package. You are neither allowed to spread it if any file
is changed. The best way to distribute it, is in a LhA archive.
It may not be included in any comercial products without contacting
the author before.
All files are also classified as SHAREWARE. That means that you are
not allowed to use for a longer time than two weeks it if you haven't
paid the shareware fee. But you are allowed to distribute it. More
about the shareware fee later.
Fred Fish have the right to include OptiMod in his Amiga Library.
Other makers of PD-series also have the right to include it as long
as all rules above are respected.
Please respect these rules, and I will continue to make new
versions of OptiMod.
All files:
OptiMod MainProgram
OptiMod.doc Documenation
OptiMod.doc.info icon
OptiMod.history Historyfile
OptiMod.history.info icon
OptiMod.RegForm Registration form
OptiMod.RegForm.info icon
2. Disclaimer
¯¯¯¯¯¯¯¯¯¯¯¯¯
The author cannot be held liable for the suitability or accuracy of
this manual and/or the program(s) it describes. Any damage (software
or hardware damage) directly or indirectly caused by the use or misuse
of this manual and/or the program it describes is the sole responsibility
of the user her/him self.
3. Author
¯¯¯¯¯¯¯¯¯
OptiMod is written by Joakim Ögren in assembler to get the
program as short and fast as possible. OptiMod requires
OS2.0 (V37+) to run, since it uses many of 2.0 features to
get it as fast,short and powerfull as possible. If you only
have 1.3 or lower I can only say: Upgrade :-)
4. Purpose
¯¯¯¯¯¯¯¯¯¯
OptiMod is a utility to optimize NoiseTracker and ProTracker
modules. All modules must be in the 31 instruments fileformat
and be a ProTracker/NoiseTracker module. ie OptiMod won't
accept any StarTrekker or 15 instruments SoundTracker modules.
To use OptiMod on any of them please load them into ProTracker
(or some other Tracker) and save it again.
OptiMod started when I saw that most modules were longer than
they would have to be. And the stupid fileformat of modules doesn't
make it shorter. Some other authors have already tried to do this
but in another way: Azatoth of Phenomena with his ProPacker, but it
changed the whole format and deleted all instrument names etc.
But by using OptiMod with the NewPM option, and then crunch/archive
them you'll gain about 10% than just crunching it.
YOU'LL SAVE ABOUT 40-50% WITH NEWPM OPTION + LhA (by Stefan Boberg)
But now with OptiMod you can optimize modules and they will sound
EXACTLY the same. OptiMod will try to do these things:
- Rearrange patterns to take less space.
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
For instance by using pattern 0,1,2 & 6. All patterns in the middle
will be saved (3,4 & 5) but unused and empty. This will gain 1024
bytes per deleted pattern. OptiMod won't delete any used pattern.
As long as it's in the 'SongPositions' it will be left.
Duplicate patterns will be removed.
- Delete unused samples.
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Every unused but existing sample will be deleted.
- Cut away zeros in the end of Samples.
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
If a instrument/sample ends with many zeros they will be cut away.
This will not affect how it sounds, if the zeros is in a loop they
will not be deleted. At least 2 zeros is always left to make the
sound not 'click' at the end.
Sample data after a loop is deleted. Watch out if you're using
the command to start playing a sample at a certain offset.
- Garbage
¯¯¯¯¯¯¯
If the module contains garbage at the end of the module it will
be cut away. Some rippers save some bytes extra just in case. But
OptiMod will cut them. Please note that Garbage gain can be negative.
If it is negative the module wasn't correct at the start. OptiMod
will add some bytes were it should be. (Load it into ProTracker,
and you'll see the same result)
Optimod has also the ability to check who has done the module. If you
use the Verbose (No option), Short or Name mode you'll see the authors
name (if any). OptiMod will search thru all sample names for strings.
5. READ THIS!!!
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
DO NOT USE OPTIMOD ON MODULES THAT AREN'T FINISHED. THIS MAY CAUSE SOME
NOT YET INSERTED PATTERNS/SAMPLES TO BE DELETED!!!
DON'T BLAME ME IF SOMETHING GOES WORNG, I HAVE NOTE YET FOUND A MODULE
THAT WERE CORRUPTED AFTER OPTIMIZING. AND I HAVE TESTED ON ABOUT 900 (!)
MODULES.
THE MODULE WILL SOUND EXACTLY THE SAME AFTER OPTIMIZATION AS BEFORE!!!
If OptiMod crashes or won't optimize a module correctly, please load it
into ProTracker and save it again.
If newer versions of ProTracker changes the fileformat or adds new
advanced commands, I can't garantee OptiMod to work correctly!
6. Template
¯¯¯¯¯¯¯¯¯¯¯
OptiMod SOURCE,DESTINATION,SHORT/S,SHORT2/S,MEDIUM/S,NAME/S,QUIET/S
NS=NOSAVE/S,NPAT=NOPATTERN/S,NSMP=NOSAMPLE/S
NSMPLEN=NOSAMPLELEN/S,NA=NOAUTHOR/S,NOPP/S,NOERROR/S
NEWPM/S,FX=EFFECT/S,BUG=UNWANTED/S,NOBUFF/S,SAMPLE=INSTR/S
SOURCE The module to optimize.
DESTINATION If omitted, the source will be the destination.
SHORT This will list FileSize before
FileSize after
Gain
SongLength. (Number of Positions)
Real Module name
Author
SHORT2 This will list FileSize after
Gain
SongLength. (Number of Positions)
How much percent with effects
Real Module name
Author
MEDIUM This will list FileSize before
FileSize after
All four Gains (Pat/Smp/SamEnd/Garbage)
Total Gain
SongLength. (Number of Positions)
Real Module name
NAME This will list Filename (no path)
Gain
Real Module name
Author
QUIET No output at all
>> If none of these output modes are selected, the optimization will be
output in Verbose mode, and when I say verbose I mean VERBOSE!
NOSAVE Only examine, don't save the file.
NOPATTERN Don't optimize patterns
NOSAMPLE Don't optimize samples usage
NOSAMPLELEN Don't optimize samples len
NOAUTHOR Don't show authors name
NOPP Don't use powerpacker.library
NOERROR No returncode=20 whenever an error occurs.
OM will return 20 if an error occurs, this
will for example directly break any script
file.
NEWPM This will convert the module into the new
PowerMusic (see notes below) module format.
The module will have the exact lenghts as
a normal module, but when you pack with
a packer/archiver it will be crunched better.
OM will always output normal ProTracker
module (except when the optimizationfailed
and no file was generated) even if the
source file was a PM-module. Keep that in mind.
READ THE POWERMUSIC DOC FOR MORE INFO!!!
EFFECT This will show some information about how much all
effect-commands are used. Both graphically and with
numbers.
UNWANTED This will spot 'bugs' in a module! You can find any
used but nonexisting sample. And nested pos-jumps
which causes some positions not to be played.
NoSave is automaticly enabled.
USE IT BEFORE RELEASING ANY MODULE!!! Please...
NOBUFF I normal cases OptiMod will allocate a little extra
bit of memory after the module, in case that the module
are trashed and some instruments are missing. Then it
will save zero's at the end istead of trash. By using
this option you'll save some bytes of memory. Only use
this if you're short of memory.
INSTR This will list all instruments. NoSave is automaticly
enabled.
Please refer to any AmigaDos 2.0 Reference for more information
about Templates and modifiers.
7. Examples
¯¯¯¯¯¯¯¯¯¯¯
OptiMod mod.LetsRock ns To just analyze the module.
Great for musicians.
OptiMod mod.LetsTwist name newpm Optimize module, save as the same
name as the Source. Show it in Name
output mode. Output file=PowerMusic
OptiMod mod.LetsBoogie mod.LB nsmp Optimize everything except sample
usage, and save as mod.LB.
8. Tips about Usage
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
It's smart to use OptiMod in conjunction with DirOpus, here is
two gadgets to use in DirOpus (v3.51+).
OptiModCheck
Executable OptiMod {f} nosave
Flags: Output window
CD source
Recursive directories
Do all files
Reload each time.
CloseDelay: -1
- Directory Opus is Copyrighted by Jonathan Potter 1990-92 -
- Published by INOVAtronics -
9. Thanks
¯¯¯¯¯¯¯¯¯
Thanks to:
Peter 'Crayon' H For his ProTracker. Get in touch if you wan't
to include this in the ProTracker.
Freelancers Previous ProTrackers..
Mahoney & Kaktus etc... for all other Trackers.
Robert Wahlström For ßeta testing some of my programs.
Nico François For his two Great libraries (powerpacker
& reqtools) which I have used in some
of my other programs.
Niklas Edmundsson For helping me with a lot ßetatesting.
Pierre Andersen For some modules.
Myself For making this wonderful program.
10. SHAREWARE
¯¯¯¯¯¯¯¯¯¯¯¯¯
This program is SHAREWARE, to get a version without the annoying
requester in the beginning you should get yourself registred. All
registred users will recieve a keyfile, this file will disable
the annoying requester in OptiMod AND in all future QTech Tools
programs which requires registration. As you recieve new versions,
(of OptiMod or other QTech Tools Programs) this keyfile will work
with them also. All distribution of the keyfile is totally forbidden!
The keyfile is personal.
You're allowed to use this program for trial period no longer
than two weeks, if you find this program usable after that trial
period you must register yourself. Register yourself by sending
50 SEK or US$10 (by international money order/postal money order
in SEK, look at Registration Form for more info). As registred user
you'll get the latest version of OptiMod and other QTech Tools
availble. If a new version is under development I will wait until
it's ready before sending the programs/keyfile. Please remember that
a lot of time and money have been spend on OptiMod and other QTech
Tools. You SHOULD GET yourself REGISTRED now!
Continuing to use OptiMod without being registred is both illegal
and inmoral! ...and #?$*& :-)
Use the Registration Form supplied with OptiMod!
11. New version.
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
To recieve the latest version of OptiMod without registering just send
a disk full with some GREAT modules (preferable done by you, if you're
Good :-> ) and some money for the stamp (optionally send a stamp). And
you'll recieve the latest version of OptiMod for free (except stamp)
To just get the latest version you don't have to send in the registration
card.
12. PowerMusic
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
PowerMusic is a new and powerfull moduleplayer. It's the best
module player ever (That's true! Ask anyone!). Here are some functions.
o Full xpk support. (Even password, priority etc)
o Full PowerPacker support.
o Full PowerPlayer module support. (PMC, thru lh.library)
o Full LhA support. (That's GREAT)
o Only for OS2.0+, uses some 3.0 functions if 3.0 is availible.
o Handles only ProTracker (NoiseTracker) and PowerMusic-modules.
o All ProTracker commands supported.
o Full support of CIA timing.
o Runs as a commodity.
o Controllable thru JoyPort.
o LongPlay function.
o Rnd order of playing.
o Nice Equalizer.
o Own module format (PowerMusic-modules), which saves 10% of filelength.
o LOTS of configuration things.
o Nice to the system (allocates audiochannels, allocates interrupts.)
o No known enforcer hits.
o Written in 100% assembler = Fast!
o Availble NOW! (Send me a disk with modules and I'll send you PowerMusic!)
13. How to contact me
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Address: Joakim Ögren /Q-Tech
Snipgränd 69
S-90624 UMEÅ
Sweden